14.2.1 REST Device Issued notification

The REST Device Issued event sends a notification to a REST web service when a device is issued and has a status of Active.

If you configure an external system with the name REST Device Issued and specify the corresponding mapping file RESTDeviceIssued.xml, you can configure MyID to respond to the event with the following.

14.2.1.1 Endpoint

POST /devices/deviceIssued

14.2.1.2 Data

Copy
{
    "person": {
        "id": "<person guid>",
        "group": {
            "id": "<group guid>",
            "name": "<group name>"
        },
        "name": {
            "first": "<first name>",
            "last": "<surname>"
        },
        "contact":
        {
            "emailAddress":"<email address>"
        },
        "employeeId":"<employee ID / security number>",
        "photo":"<base 64 encoded user image>"
    },
    "device": {
        "id": "<device guid>",
        "sn": "<device serial number>",
        "dt": "<MyID device type>",
        "validity": {
            "from": "<ISO format issuance date>",
            "to": "<ISO format expiration date>",
            "enabled": <true|false>
        },
        "hid": {
            "serialNumber": "<HID loop ID>",
            "facilityCode": "<HID facility code>"
        }
    }
}

14.2.1.3 Expected response

A 200 OK response in the event of success.